1. chokidar로-파일-변경-탐지-spec.md•1.14 kB
# chokidar로 파일 변경 탐지
## 목적
워처동기화의 핵심 시나리오를 안정적으로 제공
## 기능 요구사항
- 입력 유효성 검사 및 에러 메시지 표준화
- 성공/실패 결과를 MCP 스펙에 맞게 반환
- 로깅과 트레이싱 훅 제공
## 비기능 요구사항
- 성능: P95 < 150ms (로컬)
- 신뢰성: 에러 재시도(최대 2회), 원자적 처리
- 보안/프라이버시: 민감정보 마스킹/비저장 원칙
## API / I/O (초안)
```json
{
"tool": "워처동기화",
"input": {
"example": "value"
},
"output": {
"ok": true
}
}
```
## 데이터 모델 / 포맷
```yaml
id: "20250927T103000Z"
title: "예시"
tags: ["example"]
links: []
```
## 예외/에지 케이스
- 입력이 비어있거나 포맷 불일치
- 파일 잠금/경합 또는 인덱스 미준비 상태
## 테스트 포인트
- 단위: 명세 기반 케이스 10개 이상
- 통합: happy path + 실패 시나리오
- 부하: 샘플 1만 문서에서 60초 내 500회 호출 성공
## 완료 조건(DoD)
- 모든 테스트 그린
- 문서/샘플 업데이트
- 로깅/메트릭 노출 및 검증